logo

وب سرویس استعلام کد ملی (Client Credential)؛

سرویس «استعلام کد ملی (Client Credential)» در دسته احراز هویت و شناخت مشتری فینوتک با گرفتن کد ملی و تاریخ تولد، اطلاعات ثبت احوال شخص — از جمله نام، نام خانوادگی، نام پدر و وضعیت حیات — را برمی‌گرداند

سرویس «استعلام کد ملی (Client Credential)» در دسته احراز هویت و شناخت مشتری فینوتک با گرفتن کد ملی و تاریخ تولد، اطلاعات ثبت احوال شخص — از جمله نام، نام خانوادگی، نام پدر و وضعیت حیات — را برمی‌گرداند. با این سرویس می‌توانید بدون نیاز به تایید پیامکی کاربر، درستی هویت اعلام‌شده در فرم‌ها و پایگاه داده خود را بسنجید.

چرا وب سرویس استعلام کد ملی (Client Credential)؟

نام و کد ملی، کلید اتصال یک پرونده به یک انسان واقعی است، اما در عمل هر دو دست‌نویس وارد می‌شوند: کاربر نام خود را با غلط تایپی می‌نویسد، کد ملی را یک رقم اشتباه می‌زند یا کد ملی شخص دیگری را ثبت می‌کند. تشخیص این خطاها به‌صورت سنتی یعنی درخواست تصویر شناسنامه یا کارت ملی، انتظار برای پاسخ مشتری و بازبینی دستی کارشناس؛ فرآیندی که هم روزها طول می‌کشد و هم به قضاوت انسانی وابسته است. در پرونده‌های انبوه — مثل فهرست مشتریان قدیمی یا فهرست ذی‌نفعان یک پرداخت گروهی — این روش عملاً قابل اجرا نیست.

  • اعتبارسنجی فرم ثبت‌نام پیش از ساخت پرونده — نام و نام خانوادگی وارد‌شده با اطلاعات ثبت احوال مقایسه می‌شود تا پرونده با هویت غلط ساخته نشود.

تست فوری API استعلام کد ملی (Client Credential)

جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.

1curl --location --request GET 'https://apibeta.finnotech.ir/facility/v2/clients/TestFn/users/0011111111/cc/nidInquiry?trackId=trackId&birthDate=1372%2F07%2F14' \2--header 'Authorization: Bearer ACCESS_TOKEN'

سوالات متداول

سرویسی است که با دریافت کد ملی و تاریخ تولد، اطلاعات ثبت احوال شخص — نام، نام خانوادگی، نام پدر، تاریخ تولد و وضعیت حیات — را به‌صورت داده ساخت‌یافته برمی‌گرداند تا هویت اعلام‌شده مشتری سنجیده شود.

خروجی یکی است، مسیر دسترسی متفاوت: این نسخه با توکن Client Credential و بدون تایید پیامکی فراخوانی می‌شود و برای پردازش‌های سمت سرور و بازبینی انبوه مناسب است؛ اگر جریان کاری شما باید رضایت خود شخص را ثبت کند، استعلام کد ملی (Authorization SMS) را انتخاب کنید.

نه؛ علاوه بر صحت کد ملی، اطلاعات هویتی متناظر آن هم بازگردانده می‌شود و می‌توانید آن را با اطلاعات مشتری در سامانه خود تطبیق دهید.

اگر تنها به وضعیت حیات نیاز دارید، استعلام وضعیت حیات پاسخ متمرکزتری می‌دهد؛ این سرویس وضعیت حیات را در کنار مجموعه کامل‌تری از اطلاعات هویتی برمی‌گرداند.

صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.

Grant type: client_credentials. جزئیات در راهنمای توکن.

خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.

Top

آیا می‌خواهید شروع کنید؟

این سرویس فقط به کسب‌وکارها ارائه می‌شود

ما به محقق شدن رؤیای شما کمک می‌کنیم